home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / picsw7.arc / PICSW7.DOC next >
Text File  |  1987-04-20  |  15KB  |  294 lines
  1.    ==========================================================================
  2.                            PicSwitch Picture Utility
  3.                    (c)1987 John Brochu for Advanced Software
  4.    ==========================================================================
  5.  
  6.    Version: 0.7
  7.    Released: April 19, 1987
  8.  
  9.    PicSwitch 0.7 is distributed as SHAREWARE.  You are encouraged to freely
  10.    distribute the program, but please include this doc file with the program.
  11.  
  12.  
  13.    --------------------------------------------------------------------------
  14.    New features
  15.    --------------------------------------------------------------------------
  16.    The following enhancements have been added from PicSwitch 0.6 ...
  17.     o  Runs on color AND monochrome systems, all features supported on both
  18.        monitors except PREVIEW (color only)
  19.     o  New formats: DEGAS compressed, Tiny, and Atari 8-bit files
  20.     o  Much improved low-res and med-res to monochrome conversions
  21.     o  PicSwitch printer driver now supports all three resolutions
  22.     o  Color cycling is now supported, and is converted between formats
  23.     o  Converted pics are now saved to the original pic's directory, or
  24.        optionally using the file selector to any drive/path
  25.  
  26.  
  27.    --------------------------------------------------------------------------
  28.    About PicSwitch
  29.    --------------------------------------------------------------------------
  30.    PicSwitch started out as a simple Amiga IFF file viewer back when ST paint
  31.    programs  were hard to come by (around October of '85)!  Since then it has
  32.    undergone  lots of upgrading through versions 0.5 (the original), 0.6, and
  33.    now  0.7.  The basic intent of the program is to provide ST users with the
  34.    ability  to  view  as much artwork as possible, and to convert to a format
  35.    that  is usable to them on the ST.  With this version I have addressed the
  36.    major  complaint most people have had with the program, that is monochrome
  37.    support!
  38.  
  39.    All  pics can be viewed on either the color or monochrome monitor, and can
  40.    be  saved  in any resolution with either system, with automatic conversion
  41.    to  the selected resolution.  Conversions from a higher res to a lower res
  42.    are  automatically  optimized  using  a  color  averaging technique, while
  43.    conversions from low & med-res to monochrome use a sophisticated dithering
  44.    technique.
  45.  
  46.    Conversions  from  monochrome  allow  you the option of saving the picture
  47.    using  the  full  palette  (best if you may want to restore the pic to its
  48.    original  state  at  a  later  date)  or with the minimum possible palette
  49.    (low-res conversions would use 5 colors, med-res 3).
  50.  
  51.    MacPaint  and  NVision/Paintworks monochrome page files are also allowed a
  52.    fourth  res-save  option.   Compressed save allows you to 'squeeze' a full
  53.    720-line MacPaint document or 800-line Paintworks pic into only 240 or 267
  54.    med-res  lines,  thus  allowing  you  to view more of the pic on screen at
  55.    once.
  56.  
  57.    On  a  color  monitor,  you are allowed to 'Preview' the conversion before
  58.    saving,  without  affecting  the  original  picture.  Hi-res previews will
  59.    display the picture in PicSwitch's 'simulated monochrome' mode.
  60.  
  61.    Printouts  of  ANY  screen  or  full-page picture can now be done with the
  62.    built-in  driver on most 8-pin graphics printers.  You can also load DEGAS
  63.    printer drivers for printouts if you wish.
  64.  
  65.  
  66.    --------------------------------------------------------------------------
  67.    Supported formats
  68.    --------------------------------------------------------------------------
  69.    This version reads the following file formats:
  70.         o  DEGAS................................. [.PI1-.PI3]
  71.         o  DEGAS Elite compressed................ [.PC1-.PI3]*
  72.         o  NeoChrome.................................. [.NEO]
  73.         o  Tiny............................... [.TNY, .TN1-3]*
  74.         o  NVision.................. [.SC0-2, .CL0-2, .PG0-2]
  75.         o  Amiga IFF low- & med-res................... [.IFF]
  76.         o  MacPaint................................... [.MAC]
  77.         o  Mac Startup screen......................... [.MAS]
  78.         o  CIS Vidtex hi-res RLE...................... [.RLE]
  79.         o  Atari graphics 8 screen dump............... [.GR8]*
  80.         o  Atari graphics 9 screen dump............... [.GR9]*
  81.         o  Atari Koala/MicroIllustrator............... [.KOA]*
  82.         o  Atari MicroPainter......................... [.MPT]*
  83.  
  84.    And writes the following ST file formats:
  85.         o  DEGAS
  86.         o  DEGAS Elite compressed*
  87.         o  NeoChrome
  88.         o  NeoChrome 'page' (for NVision)
  89.  
  90.    *New additions from 0.6
  91.  
  92.  
  93.    --------------------------------------------------------------------------
  94.    Using the program
  95.    --------------------------------------------------------------------------
  96.    To  load  a  picture  using  the  GEM  file  selector, double click on its
  97.    filename  or  single-click  and  then  click  OK.   The file will load and
  98.    display.   You  are  now  in  'command  mode'.  Following is a list of key
  99.    commands available:
  100.  
  101.    For all pics...
  102.    ---------------
  103.     o  [Undo], right mouse button: aborts the pic and returns you to the file
  104.             selector.
  105.     o  [Help]: displays the command list.
  106.     o  [I]: displays the information screen.
  107.     o  [S]: displays the save dialog (see below).
  108.     o  [P]: prints the current pic in its original form (screen OR
  109.             full-page).  [Undo] aborts a printout.  The default printer type
  110.             is Epson/Atari dot matrix.  Other printers capable of 8-bit
  111.             graphics can be configured using a ".PSW" driver as described
  112.             further on.
  113.     o  [D]: dumps a color or monochrome screen to the printer.  To use this
  114.             option, you must have a DEGAS printer driver with a ".PRT"
  115.             extender present in the directory the program is in when it is
  116.             first run.  The [Alt] key works as in DEGAS, ie.[D] prints a full
  117.             page sideways, [Alt-D] prints a half-page.  Pressing [Undo]
  118.             during a print aborts the dump.
  119.  
  120.    For MacPaint/NVision pics only...
  121.    ---------------------------------
  122.     o  left mouse button: activates a 'grabber' similar to Neochrome.
  123.     o  [C] (monochrome pics / color system only): compress a monochrome page
  124.             vertically.  This option converts 3 monochrome lines into 1
  125.             med-res line.  Therefore a 720-line MacPaint document would
  126.             reduce to a 240-line med-res scrollable image.  Pressing this a
  127.             second time restores the original image.  Note this option is
  128.             available in the save dialog on both monitors.
  129.  
  130.    For Amiga IFF pics only...
  131.    --------------------------
  132.     o  [1]-[6]: selects the bit-planes to be displayed.
  133.     o  [Space]: cycles through settings [1]-[6].
  134.     o  [R],[G],[B]: boosts the selected color.
  135.     o  [Return]: restores the default planes and colors.
  136.  
  137.    Low-res  32-color  pics  have  5  'planes'  or  5  bits  of color-register
  138.    selection.   Keys 1-5 'pull out' one of the planes for display on the ST's
  139.    4-plane hardware.
  140.  
  141.    Med-res  16-color  pics have 4 planes.  Keys 1-6 in med-res therefore need
  142.    to pull out 2 planes at a time.  The following table summarizes the planes
  143.    that are displayed.  The space bar cycles through each in turn.
  144.  
  145.         +-----+---------+-----+
  146.         | key |   low   | med |
  147.         +-----+---------+-----+
  148.         |  1  | 1,2,3,4 | 2,3 |
  149.         |  2  | 0,2,3,4 | 1,3 |
  150.         |  3  | 0,1,3,4 | 1,2 |
  151.         |  4  | 0,1,2,4 | 0,3 |
  152.         |  5  | 0,1,2,3 | 0,2 |
  153.         |  6  | ---na-- | 0,1 |
  154.         +-----+---------+-----+
  155.  
  156.    Amiga's  hardware also allows 4-bit color resolution, or 16 levels each of
  157.    red,  green,  and  blue.  Since the ST only has 3-bit resolution, each IFF
  158.    RGB  color  palette entry is cut in half to bring it into the ST's range.
  159.    The  R,G,B  keys  add  one to the IFF value before halving it.  This helps
  160.    bring  out  some  of  the detail that may be lost if some of